Skip to content

Add dashboard-aware presentation to ocp-admin skills#139

Draft
ikrispin wants to merge 2 commits into
mainfrom
feat/ocp-admin-dashboard-aware
Draft

Add dashboard-aware presentation to ocp-admin skills#139
ikrispin wants to merge 2 commits into
mainfrom
feat/ocp-admin-dashboard-aware

Conversation

@ikrispin

@ikrispin ikrispin commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Add UI Widget Policy to AGENTS.md that directs agents to call UI-opening tools immediately when interactive widgets are available, falling back to skill workflows in text-only environments.

cluster-creator: Add open_cluster_creator to allowed-tools and replace Step 1 with environment detection that calls it immediately on UI-capable clients, skipping text-based parameter gathering.

cluster-inventory: Add get_cluster_hosts to allowed-tools, document dashboard auto-presentation after list_clusters, and add setup navigation tool to dependencies.

Summary

Pack(s) affected

  • ocp-admin
  • rh-ai-engineer
  • rh-automation
  • rh-basic
  • rh-developer
  • rh-sre
  • rh-virt
  • Other / repo-wide

Change type

  • New skill
  • New agent
  • New pack
  • Update existing skill / agent
  • MCP server config (mcps.json)
  • Docs / README
  • CI / tooling

Contribution method

  • Created/imported with /agentic-contribution-skill
  • Manual contribution (validated with make validate + make validate-skill-design-changed)

Pack-persona alignment (new skills only)

AGENTS.md compliance

  • Agents orchestrate skills; no direct MCP/tool calls in agents
  • Skills are single-purpose task executors
  • Skills encapsulate all tool access (MCP tools invoked only inside skills)
  • Document consultation: file is read with the Read tool, then declared to the user
  • No credentials hardcoded; env vars used via ${VAR} references
  • Human-in-the-loop confirmation added for any destructive or critical operations

Validation

  • make validate passes locally
  • New/changed skills have valid YAML frontmatter (name, description)
  • New/changed agents have valid YAML frontmatter (name, description)

Add UI Widget Policy to AGENTS.md that directs agents to call
UI-opening tools immediately when interactive widgets are available,
falling back to skill workflows in text-only environments.

cluster-creator: Add open_cluster_creator to allowed-tools and
replace Step 1 with environment detection that calls it immediately
on UI-capable clients, skipping text-based parameter gathering.

cluster-inventory: Add get_cluster_hosts to allowed-tools, document
dashboard auto-presentation after list_clusters, and add setup
navigation tool to dependencies.
@ikrispin ikrispin marked this pull request as draft July 7, 2026 15:57
### Required MCP Tools
- `list_clusters` (from both servers) - Lists clusters (auto-routes to correct API)
- `list_clusters` (from both servers) - Lists clusters and opens the Cluster Inventory dashboard on UI-capable clients. Falls back to text on others.
- `get_cluster_hosts` (from openshift-self-managed) - Opens the Cluster Setup dashboard for a specific cluster on UI-capable clients.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

IIRC, this is a new tool we've just added. Shouldn't we check about its availability first, like we did in the other "Check for interactive UI" section?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You're right, addressed in 3aa9471

@dmartinol dmartinol left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you!
/lgtm let's wait for the tools being committed upstream before merging it

Add "(optional)" and "If available" guard to get_cluster_hosts in the
Dependencies section, matching the pattern used for open_cluster_creator
in cluster-creator skill.
@ikrispin ikrispin force-pushed the feat/ocp-admin-dashboard-aware branch from bed132b to 3aa9471 Compare July 8, 2026 13:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants